---
title: amountToHangul
---

import { Sandpack } from '@/components/Sandpack';
import { Callout } from 'nextra/components';

# amountToHangul

<Callout type="error" emoji="⚠️">
  Deprecated: Please use the more flexible [`numberToHangul`](./numberToHangul) instead.
</Callout>

Converts numeric amounts to the Korean reading of the [National Institute of Korean Language](https://ko.dict.naver.com/#/correct/korean/info?seq=602) rules.

For detailed examples, see below.

```typescript
function amountToHangul(amount: string | number): string;
```

## Examples

```tsx
amountToHangul('15,201,100'); // '일천오백이십만천백'
amountToHangul('120,030원'); // '일십이만삼십'
amountToHangul('12345.6789'); // '일만이천삼백사십오점육칠팔구'
amountToHangul(15_201_100); // '일천오백이십만천백'
```

## Demo

<br />

<Sandpack>

```ts index.ts
import { amountToHangul } from 'es-hangul';

console.log(amountToHangul('15,201,100'));
```

</Sandpack>
